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Introduction to LKDOS 
The Larken disk system for the Timex 2068 is fully Spectrum 
compatible and also can be used with Aros or Lros cartridge roms 

It supports all token keywords - CAT, ERASE,LOAD,SAVE,MERGE, 
OPEN#,CLOSE# and also GOTO and PRINT that were intended to be 
used with a external mass storage device. FORMAT and MOVE are 
supplied as programs that run in ram. 

The way these commands are implimented by the Larken system is 
to preceed them with a Rand usr 100: 

eg: RAND USR 100: CAT ””, 

For easier typing and a shorter command the PRINT #4: command 
can be used instead of Rand Usr 100:. To use PRINT #4: you must 
first Open Channel 4 to the diskdrive with - 

RAND USR 100: OPEN #4, "dd” 

You can now preceed all LKdos and Ex-basic commands with 
PRINT #4: eg: PRINT #4: LOAD "filename. ex” 

If the Print #4: command is used before it has been 
initialised, error O - Invalid Stream will result. 


LKDOS File Names 
The only other difference between a Lkdos command and a 
standard cassette command, is the file name. 

Lkdos uses a file name that contains a program name up to 6 
characters followed by a two character 'extension'. A period 
separates the program name from the extension. The first letter 
of the extension tells the dos what type of file it ig . It must 
be an A,B or C 

"A’ for Array "B’ for Basic > ’C’ for Code 
The second letter of the extension can be any character exept, 
if you are saving a string array, it must be a '$". 

The extension must be two characters long. 

The only character that can’t be used in a file name is a ’T’. 
This is used as a ’wildcard’ character for use in CAT searches. 

Some examples of file names: 


"Progrm. B1” A Basic program 
"zeus.Cx” A code file 
"Names. A$” A String Array 
“Numbrs. Al” A Numeric Array 


SAVE COMMANDS 

Before you can save your programs and data to the disk, your 
disk must be formatted. (See section on setup and formatting) 
Any formula or expression in a command can be used. 

eg: PRINT #4: SAVE a$ (TO 6)+”.CT” CODE Start,End-Start 
All variations of cassette commands are supported. 


PRINT #4: SAVE ”Prog.Bl” - Basic program 
: SAVE ”Prog.B1i" LINE 100 - Basic Auto run 
: SAVE ”Prog.C1i” CODE start,length - Bytes save 
: SAVE "Prog.C1” SCREENS - Screen save 
: SAVE “Prog.Al” DATA () - Numeric Array 
SAVE "Prog. A$” DATA $() - String Array 


Before ee make sure that the write protect notch on the 
disk is not covered by a protect sticker and that the disk is 
in the drive properly with the door closed. 





LOAD 

Similarly all cassette load commands are supported. 
A special feature in the load command will allow your basic prog 
to continue even when a 'File Not Found’ error has occured. 

If you POKE 23728,100 before doing a Load command, your program 
will not stop with error T if the dos can’t find the file. 
Instead, the dos will print "NO FILE” on the screen in the 
current print position and return to your basic program. It will 
also put 101, in 23728 to indicate it didn’t find the file. 

This feature was added for programs such as wordprocessors etc. 
that load and save text or work files from within them. 

The ON-ERROR command does not recognise Lkdos errors. 


MERGE 

The Merge command differs from the cassette Merge in a few 
ways. Programs aren’t automaticaly stopped when merged like the 
cassette does. This allows ”basic overlays’ which means that a 
Basic program can be far larger than what can be loaded into the 
computer at once. You can have parts of a program merged into 
your main controlling program when necessary. 

Two rules determine from what line # the program will continue 
at, after a merge command. 

- If a running Basic program merges an other program into 
memory, the first basic program will continue and have control 
over the merged program. The merged program’s autorun line# will 
be ignored. 

- If a program is merged from a immediate command (not running) 
, the merged program will start from its autorun line # . 

If it is not an auto run program it will not run. 

Due to the fact that programs are stored on the diak in blocks, 
the maximum size of any line in a program to be merged is 1200 
bytes. Merging from disk is a complex process and there will 
be noticable difference in the speed of a merge compared to a 
load. 

The merge command doesn’t merge program variables only the 
program lines. This makes you basic overlay programs easier to 
program. 


CAT (Catalog) 

The Cat command displays the disk name, all the files on the 
disk along with the size of each file in blocks, and the type of 
disk, number of files and free blocks. 

The syntax for the Cat in the 2068 is Cat ””, - The quotes 
can be closed quotes or they can contain part of a string that 
you would like searched for, in the catalog. 

Eg: Print #4: Cat *.B2”, would print all the files 
that had ”.B2” in them. 

The 'T’ is used as a wild card character and can be substituted 
forany character. 

eg: If a disk had files called progl.B* , Progl.B* , Prog2.BB 
, Prog2.B* on it. 


And the command was - Print #4: Cat "Progf.Be” 
The Cat command would find - Progl.Bx* 
Prog2.B* 


The Spectrum does not allow the search function since the 
syntax is only - Print #4: CAT 
To send a copy of the catalog to the printer you can Open 
channel 2 to the printer then do the Cat command. 
Eg Open 82,"p" for small printer 
Print #4: Open #2,”lp” for large printer 
(note- use Lkdos Close command to close #2 . See Ex-Basic 
commands for use of OPEN command ) 2 





ERASE 

The Erase command deletes the file on the disk. The blocks used 
by the file will be made reavailable to the free blocks. 

The erase syntax requires a comma after the file name. 


GOTO 

The Goto command is used to select which diskdrive is to he 
used for the next disk commands. The Larken disk interface will 
support up to 4 drives, Numbered 0 to 3. Goto 4 is reserved for 
ramdisk. 

The selected drive will stay selected until an other Goto 
command or the system is turned off. 

Drive 0 is selected during power up. 


PRINT 

The Print #4: Print "File” displays the file to screen or 
printer directly from disk without altering your program memory. 
It can be used to search a disk for a program or even to examine 
a NMI save to see the contents of memory. The listing of basic 
programs will not print line numbers, but word processor files 
and text are fairily accurate. This command was inspired by the 
CPM ‘type’ command. 


MOVE 

Because of the size of the move command, the move command is 
supplied on the system tape (or disk) and documentation is in 
the program. Save it from tape on to disk after you have loaded 
it. 


LKDOS ERRORS 

In addition to a number of Sinclair errors used by LKdos, a 

number of extra errors are added. 

The On-Error command in the 2068 does not recognise these extra 

errors . 

S - Protect Error : Disk cannot be written to. It has a 
write protect sticker on it. 

T - File Not Found : The requested file is not in the Catalog 
This can be overridden. See load command 

U - Disk Full : There is not enough room on the disk to 
save the file Or more that 100 files in 
Catalog. 

V - Wrong File Type : The file type in the extension doesn't 
match the syntax of the command. If the 
token CODE or DATA is missing or wrong 
array type. 

W - Invalid Command : The command following the PRINT #4: is 
not used by LKdos. 

X - Cat Data Error : The Catalog cannot be read properly so 
the command is aborted. 

- CRC ERROR (num) : A cre error can will be printed on the 
Screen when the dos cannot read a block 
after 10 tries. The number following the 
Cre error is the block number. 





EXTENDED BASIC COMMANDS : 

These commands consist of extended graphic, additional Print 
' and I/O device Channels and up to 3 scrolling windows on the 
screen in proportional spaced characters. (42 to over 80 charac 
ters per line) 

GRAPHIC COMMANDS: 

— PRINT #4: DRAW width,heigth, pattern (This is a versatile 
box fill or clear command that starts at the last plot command 
that fills in the selected pattern (0 to 9 (or 10= user defined 
pattern that consists of 8 bytes starting at address 23540) 

- PRINT #4: CIRCLE x,y,pattern (This is a region filling 
command that fills from right to left, selected blank areas of 
the screen in the patterns described above. It will fill a line 
until it finds a set pixel) x,y sets the starting pos. 

- PRINT #4: INK x (immediatly changes ink color on screen) 

- PRINT #4: PAPER x (immediatly changes paper color on screen) 
— PRINT #4: POKE a,b (this does a double poke for 16 bit 
numbers . b can be 0 to 65535 

CHANNEL AND WINDOW COMMANDS : 

- PRINT #4: OPEN fn ,"”device” This attaches a channel toa 
display device. (n can be channel 2 to 15 ) device can he "w0”, 
"wl", "w2” (window O to 2) or "lp” (larg e printer ’aerco type 
IF’ only) 

- PRINT #4: CLOSE #n (n can be 2 to 15. This is 
used for closeing channels opened with the above command. Note- 
never use the Sinclar Close command (unpreceeded by Lkdos 
switch) to close a channal opened by Lkdos) 

- PRINT #4: INPUT# (window) ,top,left pos,right pos,bottom pos 

This command defines a windows size, position and color. 
"window" is 0-2 , other parameters are standard print positions 
in absolute numbers (0 to 200r31) EG: PRINT#4: INPUT#1,0,10,20,8 

This would define window #1 to have its upper left corner at 
print pos 0,10 and the window would be 10 units wide (20-10) 

The bottom of the window would be at the 8th line. 
The screen colors that are being used when the window is defined 
will stay with that window. 
— PRINT #4: CLEAR w This will clear the window (0-2) and 
restore the print pos to the top of the window . It will also 
recolor the window. 

USING WINDOWS 

To use a window you need to Open a channel to a window and then 
define the size and position with the INPUT command. 

After that, to use the window (or "lp”) you can use the 
standard commands in the 2068/Spec (not preceeded by the Lkdos 
Switch) such as Print #n or List#n .EG :if channel #10 has been 
opened to a window then PRINT #10; "TEST” would print to it. Or 
LIST #10 would list your program to it. 

The computer uses channel 2 as the channel for standard Print 
commands to the main screen. You can open channel #2 to a window 

or printer. Then all standard Print of List will be directed 
to the selected device. Also the computer uses channel #3 for 
LList or Lprint commands so if you open #3,"lp” then these comm 
ands will activate the large printer. 

You can Open #2,”lp” then PRINT#4: CAT ””, This will send 
the disk directory to the printer. 

- When any or all of the windows or large printer channels are 
used, 38 bytes (total) of memory is added to the channel 
table.This may cause a problem for a program that has machine 
code in a REM statement 





PUSH BUTTON SAVES (Nmi) 

Located on the top left corner of the disk interface is a push 

button that will save any program running in memory to disk. 

It is known as a ’snap shot’ or Nmi save push button. The button 
triggers a Non maakable interupt in the Z-80 and Lkdos software 

in that area saves the program along with all registers and 
stack pointers. 

When the NMI push button is triggered the computer will play a 

tune and then pause. The program in memory can be saved by press 


ing keys 1 to 5 which will name the file "NMI-S(1-5).CM” . It 
doesnt save the screen but saves from the start of the 
attributes file on up . The display file can be saved as 


"SCREEN.CM” by pressing "s”. Also the ”a” key will attempt to 
Stop the program by a RST 8. Pressing Enter will return to your 
program. 
To load the saved program you need to load it as a CODE file. 
eg : Print #4: LOAD ”NMI-S4.CM" CODE 


AUTOSTART PROGRAMS 

Å Basic or machine code program can be make to autorun when the 
computer is turned on if the Enter Key is held down. 

To save an auto start program, you can reduce the size of disk 
space used by clearing memory to aprox 150 free bytes (lower ram 
top with clear command). Then enter Rand USR 102:Run or Rand USR 
102: GOTO (line#). This will cause a NMI type save .After the 
tune plays, Press "d”. This will save your Program from the start 
of the attribute file to Ramtop. 

This program will auto run when the computer is turned on with 
the Enter key pressed . The memory above ramtop will be clear, 
no UDG’s. These can be loaded if necessary as a code file . 

-The line on the bottom of the screen is actually all the Z80 
registers ,interupt information and stack pointers. 

Some Spectrum emulators need to be turned on by the command 
OUT 244,3 . To make this type of emulator be able to autorun 
a program you need to add this small machine code routine. 

The best place for this routine is in the printer buffer 
at location 23300. 

CALL 102 (decimal) 


LD A,3 
OUT (244),A 
RET 
After this program has been loaded , you can save your autorun 


program by RAND USR 23300:RUN 


KEMPSTON COMPATIBLE JOYSTICK 

A Kempston compatible joystick port is on the left side of the 
disk interface. It is compatible with most software written for 
the Spectrum. It is a good idea to anchor your joystick cable 
before it attaches to the board .This will prevent damage to the 
disk interface in case you accidently pull the joystick cable. 
The joy stick can be accessed by the command IN 31. Numbers 
from 0 - 31 represent the joystick position. 


LKDOS OPERATION 

The Larken disk system consists of a Cartridge that contains 
the software for controlling the drive. This is called the Disk 
Operating System (DOS). On the cartridge is a 8K Eprom mapped in 
the 0-8K area of the Dos bank and a 8K Ram that is mapped in the 
8-16K area of the Dos bank. 

The Dos bank is activated when the cartridge senses a USR call 
(M1 cycle) at address 98 to 110 (decimal). For LKDOS commands 
only the address 100 is used (also 102 is used for saveing a 
autostart file). The other addesses are used by the dos as entry 
points for the Print #4 command and windows. 

The dos bank is deactivated when a read of write is made to 
this area of memory. 

The command - RAND USR 100: OPEN f4,"dd” is used to initi- 
alise the PRINT #4: Command to point to the LKdos cartridge. 

The PRINT #4: is easier to type than RAND USR 100: and there is 
no chance of accidently typeing a wrong USR address . The "dd” 
means "disk drive”. 

The Lkdos operating system manages all disk space allocation 
by using a track map. The map is created by the format program 
and resides in track 0 along with the catalog. By using the map 
the dos keeps track of used and unused areas of the disk. 

The catalog can contain up to 100 filenames. The blocks used 

by each file are kept in the Catalog also. 

The rear mounted board is the Disk Drive Interface . This board 
controls the drive motors and the data transfer to and from the 
disk drive(s). It can control up to 4 drives. (3” 3.5” or 
5.25” drives) The disk format used by Lkdos is double density 
with 10 sectors of 512 bytes per track (or 5120 bytes per track) 

On a 40 track Double sided drive this will give a capacity of 
over 400K per disk. On a Single sided 40 track you will have 
200K and on a 80 track double sided you will have 800K per disk. 

Also on the board is a push button that will trigger the NMI 
line un the Z-80. This is used to "capture” any program to disk. 

A Kempston joy stick port is also on the disk interface for 
use with most of the software that is produced or the Spectrum. 


NOTES on using the System 

- Never turn the power to the diskdrive on or off when there 
is a disk in the drive with the door closed. This can glitch a 
disk and cause loss of data. 

- It is a good idea to keep write protect stickers on important 
disks at all times exept when you want to save or delete a file. 

- You dont have to open the PRINT #4: command every time you 
use the Lkdos. If for example you just want to see the Cat of a 
disk, it is faster just to type Print Usr 100: CAT ””, 

But in basic programs, it is a good practice to use che PRINT#4 
command. It uses 3 less bytes that Print Usr 100: and looks 
neater . Your basic program should contain the OPEN f4,"dd" in 
it at the start of the program so that Error O - Invalid Stream 
doesn’t occur if the program is just loaded and run. 

- If you plan on distibuting some software that is on Lkdos 
disks, using disks formatted as single sided will be compatible 
on more systems than double sided disks. You can do this as long 
as you software is less than 200K. 

- The LKdos cartridge is also available for the RAMEX disk 
system and other 2068 disk systems. Your Disks are compatible 
with any of these systems. 


b 





FORMATTING 

A floppy disk, unlike a cassette must be formatted before data 
can be saved on it. Formatting initialises all tracks and 
installs a track map , directory and disk parameters on track 0. 
Any errors will be reported as CRC errors followed by number 
indicating the track number. A good format should have no errors 
reported. 

The Format command is not on the Lkdos Cartridge but is on the 
Supplied cassette. Load the cassette and put a disk in drive 0 
and close the door. The first thing to enter is the Disk Name. 
Usually the disk Name is a short name (less than 1 line) but LK- 
dos allows the Name to be up to 1000 Characters. This can be 
used for a disk description etc. The delete key (shift 0) can be 
used to correct mistakes but the editing is limited. If you 
make a big mistake you can just break the program and re RUN it. 

To end the entry of the disk name press STOP (symbol shift A). 
The drive number can be drive 1 to 4. Next is the head speed. It 
must be 6, 12 ,20 or 30 milli seconds. Most modern drives can 
run at a6 ms head speed. Some older single sided drives such as 
the SA400 Shugart run at a slow 20 ms. 

The number of sides should be 1 or 2. (Single sided or double) 

The next parameter to enter is the number of tracks. This 
number should be 35, 40, or 80. Most drives are 40 track. 35 
track drives are obsolete now and rarly used. An 80 track drive 
is also known as a Quad density drive . 

Type "y” if the drive is ready to format the disk. The drive 
should turn on and the drive should step from track to track 
until the format is completed. 

The format program can now he saved onto the disk for future 
use . 

Break the program and type Rand USR 100: CAT ””, 

You should see a directory of the disk with all the disk info 
displayed. The term BLOCK refers to one track. The total Blocks 
on a disk is the (number of sides ) X (the number of tracks) . 

The dos numbers the blocks starting from track 0 side 0 . Block 
1 is track O side 1 . Block 2 is track 1 side 0 .Block 3 is 
track 1 side 1 and so on. 

The Format routine creates a track map on the directory track 
(block 0) that corresponds to the num of tracks and num of sides 
that were entered. 

When you format a single sided disk, the format routine creates 
a track map on the disk that has all side 1 tracks set as in 
use. 

Because the dos reads tracks from side to side, you cannot read 
a double sided disk with a single sided drive. Also because of 
track density, disks formated on an 80 track drive can’t be read 
from 35 or 40 track drives. 

You can however read single sided disks with a double sided 
drive. So if you have a double sided drive and you would like to 
transfer files to someone with a single sided drive, you can 
format your disk as single sided. 

All software on disk from Larken Electronics will be supplied 
on Single sided 40 track disks unless requested otherwise. 





SETUP PROCEDURE 

Your new Larken disk system contains some chips that can be 
destroyed by static electricity. This is why to boards are 
wrapped in aluminum foil during shipping. Observe anti- 
static precautions when handling these boards. Always make sure 
that all power is turned OFF when installing or removing either 
of the boards. 

In addition to the Larken boards, you will need a disk drive(s) 
» a disk drive cable and a diak drive power supply. The disk 
interface can control any floppy drive exept an 8” drive . 

The power supply needs to supply 5 volts and 12 volts. The cur- 
rent rating depends on the number of drives, but a general rule 
is 1 amp (on SV and 12V) per drive. 

When using more that 1 drive, set the drive select jumpers on 
each drive, as drive 0 to 3 respectivly. Also make sure that all 
termimator resistor packs are removed from the drives EXEPT the 
drive that is connected closest to the end of the drive cable. 
Connect the cartridge and interface to the 2068 . Turn on the 
2068 type Print Usr 100. You should get the error message 
- W Invalid Command . 

Connect the drive cable to the interface and drives and power 
up the drives and 2068. The drives should not turn on. If they 
do, you may have the drive cable reversed. 

To test to see if drives are connected properly, insert a disk 

into drive 0. Type Print Usr 100: Cat ””, 
Drive 0 should turn on (LED and motor) and then after the aprox 
15 seconds it should have turned off. To test the other drives, 
Use the command Print Usr 100: GOTO drive number (0-3) then use 
the Print Usr 100: Cat ””, to activate the drive. 


If you did not purchase the disk drive cable you can make your 
own useing 2 feet of 34 conductor ribbon cable and 2 or more 

34 position ribbon cable edge card connectors. The best way to 
install the connectors on to the cable is to use a Vise to 
squeeze the connector. The connector on the interface end should 
be mounted opposite to the drive connector(s). If you use more 
than 1 drive, space the drive connectors 3” apart. 

Installing the cable on backwards will not cause any damage, 
but the drives will turn on. 


Drives 
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EXTENDED BASIC DEMO PROGRAMS 


REM 33% WINDOW DEMO 33% 
PRINT USR 100: OPEN #4, "dd” 

CLS : INK 7: PAPER 0 

PRINT #4: OPEN 85,"w0" 

PRINT 44: INPUT #6,3,3,15,10 

INK 0: PAPER 4: 

PRINT #4: OPEN #6, "wl" 

PRINT #4: INPUT #1,12,10,30,20 

INK 0: PAPER 7: CL$ 

PRINT #4: CLEAR 0: PRINT #4: CLEAR 1 

PRINT #0; "Press Enter for ”SCROLL ???’” 

LIST #5: LIST #6: LIST #5: LIST #6: LIST #5 


REM 33% DRAW DEMO 33% 

RANDOMIZE USR 100: OPEN #4, “dd” 

LET x=INT (RND#200): LET y=INT (RND*150) 

PLOT x,y: PRINT #4: DRAW 40,40,1 

Eo ra sah PRINT #4: DRAW 36,36,INT (RND#¥8) +1 


Tn *% FILL DEMO 3333 


PLOT 30,20: DRAW 70,0: DRAW 60,60: DRAW 0,50: DRAW -35,35 
DRAW -60,-60: DRAW å R DR 


REM 
PRINT #4: CIRCLE 50,50,8 

PRINT #4: CIRCLE 100,100,2 

PRINT #4: CIRCLE 130,60 

REM -- UDP for Pattern 10 -- 

RESTORE 

FOR a=23540 TO 23548 

READ b: POKE a,b 

NEXT a 

DATA 15,240,15,240,15,240,15,240,15,240 
PRINT #4: CIRCLE 80,80,10 

REM --- Cut Door <-~-~~--- 

PLOT 60,20: PRINT #4: DRAW 10,20,1 

PLOT 61,20: PRINT #4: DRAW 8,19,0 


FROM: 
LARKEN ELECTRONICS 
RR#2 NAVAN ONTARIO 
CANADA K4B-1H9 





ADDING a LROS Cartridge chip to the LKDOS Cartridge 

Don't attempt this unless you have a proper soldering iron 
and experience in delicate soldering. Larken Electronics will 
do this mod for #5. 

Parts needed - 28 pin IC socket , 74HCTS2 IC 

Use a low power soldering pensil that is properly grounded. 

~ temperarily remove the eprom from the LEDOS cartridge. Bend 
pins 20 and 22 on the socket outward. Note - all IC’s have there 
pin 1 (dot or notch) towards the center of the cartridge. 

Install the 28pin socket on top of the 8k ram IC (the 28 pin IC 
that is solded to the board). Carefully solder all pins exept 
20 and 22. (you only need a tiny bit of solder). Carefully 
remove all leads from the 74HCT32 exept pins 1,2,3,7,14. Bend 
pins 1 and 3 up (fold the lower half back up). Stack this chip 
on top of the middle 14 pin IC. (pin 1 faces in) and solder the 
pins 2,7 and 14 to the same pins on the IC beneath. 

Run a small wire from pin 3 on the HCT3Z to pins 20 and 22 on 
the 28 pin socket. Run a small wire from pin 1 on the HCT22 to 
the ROS enable connection near the buss. thats it ! 

Check for any shorts or solder bridges . Reinstall the LKDOS 
eprom and test it in the 2068 to see if it still works ok. 

Remove the eprom for your 05-64 or Spectrum emulator and insert 
it into the socket. If it doesnt work, recheck your work 

If you have a Spectrum ROM chip (not Eprom), part num: 23128 
it may not work unless you bend pin 27 out (so it doesnt go in 
to the socket) and ground this pin (connect a small wire from 
pin 14 to pin 27). 


Pin 14 Not Gert 
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